home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / xword.arc / XWORD.DOC next >
Encoding:
Text File  |  1986-02-23  |  9.0 KB  |  195 lines
  1.  
  2.                          INTRODUCTION
  3.  
  4.     XWORD is a general file format transformer; that is, it con-
  5. verts files from one format to another. Selections are made from
  6. two menus, "FORMAT CONVERTERS" and "LOGICAL OPTIONS." Since XWORD
  7. is not tricky to use, this file deals with general operation
  8. procedures, some problems, and what XWORD does not do. I have
  9. made some arbitrary decisions regarding what XWORD does to files.
  10. Sometimes it is not possible, or not possible without great
  11. difficulty, to preserve print options between different word
  12. processing formats. In some of these cases, I have elected to
  13. eliminate them and let the user re-input them anew. For those
  14. word processors which require a line length embedded in the
  15. files, I have chosen one arbitrarily, based on my own experience.
  16. If this proves burdensome for users, I will find another way.
  17.     Since XWORD is not a frozen, static program, but one which I
  18. am continually changing (and, hopefully, improving), no feature
  19. of XWORD need be considered as irrevocable. If users (or par-
  20. ticular users) have a need for a certain type of revision, that
  21. can be done.
  22.     XWORD appends a 1AH to the ends of files under certain
  23. options. Those options that convert files to ASCII format all ap-
  24. pend a 1AH to the file. This is not required for MS/PC-DOS, but
  25. it is necessary in CP/M, to which ASCII files can be ported.
  26.  
  27.  
  28.                            WILDCARDS
  29.  
  30.     XWORD supports wildcards (* and ?) in the source file name.
  31. When wildcards are used, XWORD will overwrite the source file (a
  32. warning to that effect appears) except when converting TO MultiMate.
  33.  
  34.  
  35.                            MENU ONE
  36.  
  37.                         REDUCING SPACES
  38.  
  39.     Use only with WordStar-compatible files. DO NOT USE WITH MUL-
  40. TIMATE FILES OR WITH WORDSTAR 2000 FILES. You will have to reboot
  41. if you try to load a file processed with the P option into Multi-
  42. mate or WordStar 2000.
  43.  
  44.  
  45.              WORDSTAR, WORDSTAR 2000, AND SIDEKICK
  46.  
  47.      No special precautions need be taken regarding these files.
  48. Both WordStar and WordStar 2000 will allow any kind of file name.
  49. There is still a problem with tab handling (by XWORD), but the
  50. rest of the options of the two should be OK. XWORD will support
  51. WordStar 2000's JUSTIFY.FRM, RAGGED.FRM, MEMO.FRM, and
  52. NORMAL.FRM. It will not support the NOFORM.FRM. This format is
  53. identical to ASCII. Thus, if converting a file produced with
  54. WordStar 2000 and NOFORM.FRM, select ASCII as the source
  55. fileformat.
  56.     Sidekick is compatible with WordStar, BUT, the tabs of
  57. files written in WordStar's non-document mode show up as capital
  58. "I"s in Sidekick. XWORD expands expands these tabs so they will
  59. appear properly.
  60.     If your file in WordStar2000 looks funny when XWORD is
  61. through with it, place the cursor at the beginning of the
  62. paragraph and press any letter (you will have to erase the letter
  63. you input). This will cause WordStar2000 to reformat the
  64. paragraph.
  65.  
  66.  
  67.                            MULTIMATE
  68.  
  69.     XWORD supports conversion both into and out of MultiMate. For
  70. conversion out of MultiMate, it is important that you repaginate
  71. your files first. After conversion, check to make sure that there
  72. is no unwanted or misplaced text (MultiMate does not always
  73. eliminate old versions of pages, but stores them and skips over
  74. them when editing a file; also MultiMate sometimes stores pages
  75. out of sequence). Repagination cuts down on this, but may not
  76. eliminate it completely.  When converting from WordStar, be care-
  77. ful of indents. Make sure that indents begin after a hard return
  78. or ^PM (equivalent to 0DH). MultiMate requires all document files
  79. have the extension .DOC; XWORD appends this extension to
  80. MultiMate-target files. You will notice that the converted Multi-
  81. mate file will often have more indents than it should. This is
  82. due to the algorithm I used; a future version of XWORD will solve
  83. this problem. I have used XWORD to convert a 42+K file to Multi-
  84. Mate with no problems.
  85.  
  86.  
  87.                         XYWRITE II PLUS
  88.  
  89.     No special precautions need be taken here, as XyWrite II is
  90. very friendly. (XWORD has been tested on Version 1.00.)
  91.  
  92.  
  93.                           WORDPERFECT
  94.  
  95.     No special precautions are needed regarding conversion to or
  96. from WordPerfect.
  97.  
  98.  
  99.                            MENU TWO
  100.  
  101.     The options on this menu are for bit and byte manipulation.
  102. Some of them can be used for a quick and dirty type of
  103. cryptography. Three of the options require the user to input a
  104. value in hexadecimal format (digits 0-9 and letters A-F, which
  105. represent our common notion of 10, 11, 12, to 15); they are:
  106. AND,OR, XOR. Another one, NOT, requires no other input from the
  107. user than the source and target file names. ROL and ROR require
  108. the user supply a number between 1 and 7, inclusive.
  109.  
  110.     The action of NOT, ROL and ROR are fully reversable. That is,
  111. if NOT FileA produces FileB, and NOT FileB produces FileC, then
  112. FileC is identical to FileA. ROR (ROtate through Right) and ROL
  113. (ROtate through Left) circulate the eight bits that compose each
  114. byte. ROR 1 time shifts the bits in each bit right once; the
  115. rightmost bit is moved to the leftmost position (this information
  116. is merely for the elucidation of the user; the user does not have
  117. to understand the action of these options in order to use them).
  118. ROL 1 acts in the same way, but to the left. ROR 2 is the same as
  119. ROR 1 and then ROR 1 again. If FileA is processed with ROR 3,
  120. say, producing FileB, and FileB is processed using ROL 3, produc-
  121. ing FileC, then FileC is identical to FileA. You can use a
  122. sequence of these options to scramble a file pretty well (but
  123. remember to record your sequence and go through it in reverse to
  124. unscramble it). That is, if your sequence was:
  125.  
  126.                  ROR 4, NOT, ROL 3, NOT, ROL 2
  127.  
  128.                 then to undo this, you must go:
  129.  
  130.                  ROR 2, NOT, ROR 3, NOT, ROL 4
  131.  
  132.  
  133.                             REPLACE
  134.  
  135.     The last option on this menu, Replace, is different from the
  136. others. Replace allows the user to replace any text (ASCII) or
  137. hexadecimal string (a string is a sequence of bytes) by any other
  138. text or hexadecimal string. The two strings do not have to both
  139. be ASCII or hex. Additionally, the user can elect to save these
  140. strings and reuse them (especially useful if they were compli-
  141. cated to figure out). The user will be prompted for a source file
  142. and then a target file; then, whether the string is to be entered
  143. in ASCII, hex, or from a previously saved file. If the user en-
  144. ters a string in ASCII or hex, XWORD will ask if the user wants
  145. to save the string. This sequence is repeated for the replacement
  146. (new) string. Each string can be 30 bytes (characters) long. When
  147. entering hex, note that each hex digit must be composed of two
  148. numerals (including letters). Thus, the string more commonly
  149. written as 0DH,0AH,27H,64H,0FFH, would be enterd as 0D0A2764FF.
  150.     Remember that if you rEplace a commonly occurring byte in a
  151. file with a long string, then your target file could become up to
  152. 30 times as large as the original file. If users find longer
  153. strings are more useful, I will change XWORD to accommodate
  154. that need.
  155.     If you make an error during hex entry, hit the backspace key,
  156. and you will be reset to the beginning of hex entry. Generally in
  157. XWORD, hitting the space bar, return, or end key will let you es-
  158. cape from one level of the program to another, and, except when
  159. files are actually being converted, control-C always works.
  160.  
  161.  
  162.               OWNERSHIP, COPYRIGHTS, DISCLAIMERS
  163.  
  164.     XWORD is the property of Ronald Gans; XWORD is unpublished
  165. and copyrighted. XWORD may not be sold for profit by anyone. If
  166. you purchased XWORD for more than the price of a disk, shipping,
  167. and handling, you got taken and should notify me of that fact,
  168. along with the name of the person or corporation from whom you
  169. purchased XWORD. XWORD.EXE and XWORD.DOC may be freely copied and
  170. distributed, but may not be altered in any way by anyone. If you
  171. wish an alternate version of XWORD, please let me know. Please
  172. direct all correspondence to:
  173.  
  174.                           RONALD GANS
  175.                      350 WEST 55TH STREET
  176.                    NEW YORK, NEW YORK 10019
  177.        CompuServe No. 74216,264 Telephone (212) 957-8361
  178.  
  179.  
  180.                              MONEY
  181.  
  182.     If you send me $15.00 (N.Y.State residents $16.24), I'll put
  183. your name on a list so when revisions of XWORD are ready, or im-
  184. portant bugs are discovered, I'll inform you by postcard, along
  185. with the names and phone numbers of some BBSs from which they can
  186. be downloaded. For $3.00 more, you'll get a year's worth of revisions
  187. mailed to you.
  188.     WordStar and WordStar 2000 are registerd trademarks of
  189. MicroPro International Corporation. Multimate is a regis-
  190. tered trademark of MultiMate International. XyWrite II Plus is
  191. a registered trademark of XyQuest Inc. Sidekick is a regis-
  192. tered trademark of Borland International. WordPerfect is a regis-
  193. tered trademark of Satellite Software.
  194. dekick is a regis-
  195. tered trademark of Borland International. WordPerfec